home *** CD-ROM | disk | FTP | other *** search
/ Internet Surfer 2.0 / Internet Surfer 2.0 (Wayzata Technology) (1996).iso / pc / text / mac / faqs.349 < prev    next >
Encoding:
Text File  |  1996-02-12  |  27.6 KB  |  788 lines

  1. Frequently Asked Questions (FAQS);faqs.349
  2.  
  3.  
  4.  
  5. QUESTION: How can I write codes suitable for building shared library ?
  6.  
  7. ANSWER: (H.J. Lu, hlu@eecs.wsu.edu, 09/01/92)
  8. There are some guidelines for writing codes suitable for building the
  9. shared library with jump table.
  10.  
  11. 1. Never, ever allow library users to access global data directly.
  12.    Always, always make them go through access functions.  That way,
  13.    you are free to change the internal implementation, but can
  14.    easily provide backward compatibility by simply replacing the
  15.    access functions.
  16.  
  17. 2. If you do have to define some global data for library users to
  18.    access, put them into a separate file. Never mix them with other
  19.    library code. Also make sure the relative locations of the global
  20.    data will not change very often. One solution is leave some spaces
  21.    for them to grow.
  22.  
  23. X. SCSI SPECIAL
  24. ===============
  25. *** This section is written by Drew Eckhardt, mail him for any
  26. *** information, questions related to this section.
  27. *** Last update November 1992.
  28.  
  29.  
  30. QUESTION: What SCSI hosts are supported?
  31.  
  32. ANSWER: The Adaptec 154x, Adaptec 174x Future Domain 16x0,  Seagate ST0x,
  33. Ultrastor 14F, and Western Digital 7000FASST  are supported.  Various Adaptec
  34. clones from Bustek and Future Domain are known to work, in both ISA and EISA
  35. flavors.
  36.  
  37. The TMC 950, and the discrete 8xx implementations will be supported
  38. in the new Seagate driver when debugging is finished.  If you want to
  39. use an older kernel, add 0x200 to the status and data register addresses.
  40.  
  41. Not very many BIOS signatures are included for the Future domain boards, so
  42. they may not auto-detect correctly.
  43.  
  44. QUESTION: Which disks ?
  45.  
  46. ANSWER: Anything that works with your host adapter electronically, and
  47. is new enough to support a December 1985 draft of SCSI-I.
  48.  
  49. Sysquest, and other removeable hard disks are supported.
  50.  
  51. Extended partitions also work, with 11 Extended partitions per disk
  52. allowed in combination with the four real partitions and whole disk
  53. sub device.
  54.  
  55. Disks up to two terabytes in size will work, since the sd drier
  56. switches to 10 byte reads when necessary.
  57.  
  58. QUESTION: What about SCSI tapes ?
  59.  
  60. ANSWER: Tapes are supported in the alpha SCSI drivers.
  61.  
  62. QUESTION: What about CD ROMS?
  63.  
  64. ANSWER: Stable support is in the kernel for SCSI CD-ROM drives, and the
  65. ISO-9660 file system is in beta test.  Rockridge extensions are supported.
  66.  
  67. QUESTION: How do I get SCSI information?
  68.  
  69. ANSWER: Subscribe to the SCSI channel of the linux-activists mailing list.
  70. mail linux-activists@joker.cs.hut.fi
  71. And put in the header.
  72.        X-MN-Admin: join SCSI
  73.  
  74. QUESTION :  I can't make a filesystem on /dev/hd*
  75.  
  76. ANSWER : /dev/hd* aren't your SCSI disks.  /dev/sd* are.
  77. See below for approproate major / minor numbers if they
  78. do not exist on your root diskette.
  79.  
  80. QUESTION: How do I partition the disk?
  81.  
  82. ANSWER: Use pfdisk or the DOS parititioning program of your choice
  83.  
  84. QUESTION: My partitioning program can't figure out the disk geoemetry
  85.  
  86. The problem with partitioning SCSI disks and Linux is that Linux talks
  87. directly to the SCSI interface.  Each disk is viewed as the SCSI host
  88. sees it : N blocks, numbered from 0 to N-1, all error free.  There is
  89. no portable way to get disk geometry.
  90.  
  91. However, DOS doesn't like things like this, it demmands that BIOS
  92. present it with a normal Cylinder / Head / Sector coordinates.  So,
  93. BIOS does, and it comes up with some fabrication that fits what DOS
  94. wants to see.  You don't want to disagree with what BIOS thinks when
  95. you write the partition table.
  96.  
  97. The newest SCSI code will return the mapped geometry for some host
  98. adapter / disk combinations. Get the latest SCSI code from
  99. tsx-11.mit.edu:/pub/linux/ALPHA/scsi
  100.  
  101. QUESTION: The stock {f,pf}disk programs don't work.
  102.  
  103. ANSWER: At least some older versions of these partitioning programs have
  104. /dev/hd* hardcoded into them, and they don't see /dev/sd*.
  105.  
  106. If you want, YOU can change the /dev/hd* devices to be links to or
  107. other entries for the SCSI devices.
  108.  
  109. Also, pfdisk should be callable with a device name.
  110.  
  111. Hopefully, some one will change the partitioning programs to respect
  112. the SCSI devices.
  113.  
  114. QUESTION: Where is the latest version maintained?
  115.  
  116. ANSWER: tsx-11.mit.edu:/pub/linux/ALPHA/scsi
  117.  
  118. Join the list before you grab anything.
  119.  
  120. eric@tantalus.nrl.navy.mil (Eric Youngdale) added scatter/gather support
  121. to the SCSI drivers, and changed around the internal structures to get
  122. something that works as "version 2"
  123.  
  124. QUESTION: What are the major / minor numbers for SCSI drives?
  125.  
  126. ANSWER: Because of the large number of devices that can be hung off of
  127. a SCSI bus (as many as 56 if you use SCSI fanouts or bridge boards),
  128. and the possibility of 16 partitions on a SCSI disk, we'd run out of
  129. minor numbers if they were statically allocated - so a dynamic
  130. numbering scheme is used.
  131.  
  132. Block device major 8 is used for SCSI drives, 9 for SCSI tapes, and
  133. 11 for CD-ROMs.
  134.  
  135. Minors are assigned in increments of 16 to SCSI disks as they are
  136. found, scaning from host 0, ID 0 to host n, ID 7, excluding the host
  137. ID.  Most hosts use ID 7 for themselves.
  138.  
  139. A minor where minor mod 16 = 0 is the whole drive, where minor mod 16
  140. is between 1 and 4, that partition, extended partitions dynamically
  141. assigned from 5 to 15 inclusive.  Note that the gendisk.c module
  142. prints partition tables on initialization - you should be able to see
  143. them there.
  144.  
  145. Example : I have four SCSI disks, set up as follows
  146.         Seagate ST02, ID=0
  147.         Seagate ST02, ID = 5
  148.         Ultrastor 14, ID = 0
  149.         Adaptec 1542, ID = 0
  150.  
  151. The first disk on the seagate at ID 0 will become minors 0-15
  152. inclusive, the second at ID5 16-31 inclusive, the disk on the
  153. Ultrastor 32-47, on the Adaptec 48-63.
  154.  
  155. QUESTION: How do I reduce kernel bloat and eliminate the drivers I
  156. don't want?
  157.  
  158. ANSWER: Simply #undef CONFIG_DISTRIBUTION in include/linux/config.h,
  159. and define the macros for the SCSI hosts you want enabled.
  160.  
  161. QUESTION: I get SCSI timeouts.
  162.  
  163. ANSWER: Make sure your board has interrupts enabled correctly.
  164.  
  165. QUESTION: The seagate driver doesn't work.
  166.  
  167. ANSWER: There are several possibilities
  168. 1) Is the board jumpered for IRQ5 ?
  169.  
  170. The factory settings are
  171. for MSLOSS, and have interrupts disabled.  Interrupts are controlled
  172. by the W3 (ST01) or JP3 (ST02) jumper, which should have pins FG
  173. shorted.  See your manual.
  174.  
  175. 2) Cached machines will not have problems IF the Seagate's address
  176. space (typically C8000 - CAFFFF) is not marked "non cacheable."
  177. This applies to the i486 internal cache as well as i386/i486
  178. external caches.
  179.  
  180. This can be set in the XCMOS of most machines.  If you can't disable
  181. cache for the Seagate's area (16K in size, starting at the base
  182. address), then you must disable the cache entirely, otherwise
  183. it won't work.
  184.  
  185. 3) The new seagate drivers (not yet released) can operate in a mode where
  186. the 0ws ISA bus line is used to synchronize the ISA and SCSI busses.
  187. This makes things fast, since the alpha Seagate driver can dump SCSI data out
  188. fast enough to swamp the bus.  However, this will only work if the 0ws
  189. jumper is enabled.  If this isn't the case, the Seagate driver "should" detect
  190. this as an over/under run condition, but it might not.  Either enable
  191. the 0ws jumper, or #undef FAST in seagate.h.
  192.  
  193. QUESTION: The Adaptec driver doesn't work.
  194.  
  195. ANSWER: The Adaptec BIOS does some initialization that affects
  196. the driver.  If the BIOS was disabled, it may fail on your system.
  197.  
  198. Older versions of the SCSI drivers ran the 174x in 1542 emulation
  199. mode, where some of these cards have a bug that interferes with
  200. reads / writes > 512 bytes.
  201.  
  202. The new SCSI drivers support the 174x in 'native' mode, so this isn't
  203. a problem.
  204.  
  205. QUESTION: What about bugs?
  206.  
  207. ANSWER: It works on MY hardware.  It works on Tommy Thorn's Adaptec
  208. system, Dave Gentzel's Ultrastor, Thomas Wuensche's WD7000, Rick
  209. Faith's Future Domain, and quite a few other systems.
  210.  
  211. Bugs that are there will mostly be very hardware specific, and nasty
  212. to track down.  SCSI should be basically error free - consequently,
  213. the error code has not been heavily tested, and there are known bugs
  214. in it.
  215.  
  216. If you have found a bug, please mail it to the mailing list with
  217. specifics of your hardware.  Other people may have the same problem, a
  218. solution, etc.
  219.  
  220. If you provide a patch, in context diff form, the bug will be fixed
  221. Immediately.  If you can provide me with a procedure that reproduces
  222. the bug on *MY* system, the bug will be fixed "soon."  Your chances
  223. of getting it fixed increase exponentially with the amount of
  224. information provided.  If I can't reproduce it, and your
  225. description gives me no idea as to where in the code to  look,
  226. it won't get fixed by me.
  227.  
  228. QUESTION: What are the known bugs?
  229.  
  230. ANSWER :
  231.  
  232. Many of the drivers cannot abort a command that is in progress - if
  233. something goes haywire, all drives off that controller will hang.
  234.  
  235. QUESTION: I get a message saying READ CAPACITY FAILED. What does this
  236. mean?
  237.  
  238. ANSWER: UPGRADE.
  239.  
  240. QUESTION: Why does the system "hang" when SCSI disk access occurs.
  241.  
  242. ANSWER: Older Linux distributions (pre .97)  used  earlier versions
  243. of the SCSI drivers, where the drivers were not interrupt driven
  244. (easier debugging, or so we thought).  Since the drivers did not return
  245. from the device driver strategy routine, until the SCSI command
  246. completed, no other tasks were scheduled, and ineteractive performance
  247. was abysmall.
  248.  
  249. UPGRADE.
  250.  
  251. QUESTION: Why can't I swap to a SCSI disk?, Why can't I mount a SCSI
  252. disk as root?
  253.  
  254. ANSWER: This was due do a race condition that has since been fixed.
  255.  
  256. UPGRADE.
  257.  
  258. QUESTION: What future developments are planned?
  259.  
  260. ANSWER: The following changes will/have occurred :
  261.  
  262.         - have occurred :
  263.  
  264.         - support for scatter / gather is there.  This
  265.           means that all read (and readaheads) will be
  266.           handled via one command.
  267.  
  268.         - Significant changes have been made to the
  269.               Seagate driver.  Among other things, it supports the
  270.           0ws line, which means we can dump data fast enough
  271.           to flood the bus.
  272.  
  273.         - Multiple outstanding commands per LUN are supported.
  274.           This should result in vastly improved performance
  275.           on multi-device systems.
  276.     
  277.         - SCSI tapes are supported.
  278.  
  279.         - Support for LUN !=0 is there.
  280.     
  281.     - Planned
  282.         - SCSI commands are issued as linked commands
  283.           wherever possible, eliminating the arbitration /
  284.           selection / message out phases needed to start
  285.           a command "from scratch".
  286.  
  287.         - I have the mode page specs, and am looking at
  288.           doing "appropriate things" w.r.t. cache enable,
  289.           buffer control, etc.  It seems that some drives
  290.           power up, and keep the buffer off until told otherwise
  291.           in software.
  292.     
  293.  
  294. QUESTION: What drivers does the new code support.
  295.  
  296. ANSWER: ALL of the existing drivers work fine.  However, only an Adaptec
  297. scatter/gather driver is included in the alpha package.  The seagate
  298. scatter/gather driver is fast but not yet stable and still kernel
  299. panics.
  300.  
  301. QUESTION: WHEN?
  302.  
  303. ANSWER: Again, thanks to Eric's code contributions, it's available in
  304. alpha test now.
  305.  
  306.  
  307.        ===================8<==========>8================--
  308. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  309. #    LaBRI              |                        #
  310. #  351 cours de la Liberation    |  e-mail:  corsini@labri.greco-prog.fr    #
  311. #  33405 Talence Cedex         |                        #
  312. #                   |                        #
  313. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  314. --
  315.   There will be some sig, once our local net will be reliable.
  316.         Right now I rather stay anonymous.
  317. Xref: bloom-picayune.mit.edu comp.os.linux:18317 news.answers:4213
  318. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!usc!zaphod.mps.ohio-state.edu!cs.utexas.edu!uunet!mcsun!julienas!corton!geocub!labri.greco-prog.fr!corsini
  319. From: corsini@labri.greco-prog.fr
  320. Newsgroups: comp.os.linux,news.answers
  321. Subject: Linux Frequently Asked Questions 4/4 [monthly posted]
  322. Summary: Linux, a small and free unix for 386-AT computers.
  323. Message-ID: <PART4_722647309@geocub.greco-prog.fr>
  324. Date: 24 Nov 92 23:22:15 GMT
  325. Expires: Sat, 19 Dec 1992 23:00:00 GMT
  326. References: <PART3_722647309@geocub.greco-prog.fr>
  327. Sender: corsini@greco-prog.fr (Marc-Michel CORSINI)
  328. Reply-To: linux@numero6.greco-prog.fr
  329. Followup-To: poster
  330. Organization: Greco Prog. CNRS & LaBRI, Bordeaux France
  331. Lines: 1150
  332. Approved: news-answers-request@MIT.Edu
  333. Supersedes: <PART4_722567366@geocub.greco-prog.fr>
  334.  
  335. Archive-name: linux-faq/part4
  336. Last-Modified: 92/11/20
  337. Version: 1.11
  338.  
  339. *********************************************************
  340. *                            *
  341. *   Answers to Frequently asked questions about Linux   *
  342. *                            *
  343. *********************************************************
  344.  
  345. This post contains Part 4 of the Linux FAQ (4 parts).
  346. It must be read *after* the 3 first parts.
  347.  
  348. ===================================8<====>8============================
  349. CONTENTS (of this part)
  350.  
  351.     XI.    X11, THE MAXIMUM and MORE    (part4)
  352.     XII.    NETWORKING and LINUX        (part4)
  353.     XIII.    EMACS for LINUX            (part4)
  354.  
  355. ===================================8<====>8============================
  356.  
  357.  
  358. XI. X11 THE MAXIMUM and MORE
  359. ============================
  360. *** This section is maintained by Krishna Balasubramanian
  361. *** <balasub@cis.ohio-state.edu>. Mail him if you have corrections,
  362. *** additions, etc.
  363. *** Last update: Tue, 17 Nov 92 19:06:57 -0500
  364.  
  365. XI.A. X386 GENERAL INFORMATION
  366. XI.B. HARDWARE REQUIREMENTS: Supported Video cards.
  367. XI.C. LINUX DISTRIBUTION: Files required, Current version.
  368. XI.D. LEARNING/USING X: Pointers to X documentation.
  369. XI.E. DEBUGGING STARTUP PROBLEMS: Checklist, Screen restoration, Hanging.
  370. XI.F. XCONFIG: Video mode settings and common errors in Xconfig.
  371. XI.G. X-APPLICATIONS: Compiling X programs.
  372. XI.H. BUGS
  373.  
  374. The X11 directories are (depending on your version of X)
  375. XLIB = /usr/X386/lib/X11/ or /usr/lib/X11/
  376. XBIN = /usr/X386/bin/ or /usr/bin/X11/
  377.  
  378.  
  379.  
  380. XI.A. X386 GENERAL INFORMATION
  381. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  382.  
  383. QUESTION: What is the X11 release supported by Linux?
  384.  
  385. ANSWER: It's the X11R5 (xfree86-1.1).
  386.  
  387.  
  388. QUESTION: What is X386/xfree86?
  389.  
  390. ANSWER: X386 is the port of the X11 server to System V/386 that was
  391. done by Thomas Roell (roell@informatik.tu-muenchen.de).  It supports a
  392. wide variety of VGA boards.  X386 1.2 is included in MIT's X11R5
  393. distribution.
  394.  
  395. The Linux X386 port was based on the stock distribution from X11R5,
  396. from MIT and was done by Orest Zborowski (obz@sisd.kodak.com).
  397.  
  398. It has since moved to becoming part of the standard xfree86 distribution.
  399.  
  400.  
  401. QUESTION: Where can I get X386 1.2 (X11R5)?
  402.  
  403. ANSWER: The X386 1.2 and xfree86 sources are available at any site that
  404. distributes the X11R5 source (too numerous to list here, but includes
  405. export.lcs.mit.edu)
  406.  
  407.  
  408. QUESTION: Any tips on compiling X11R5?
  409.  
  410. ANSWER:
  411. -  Dont do it.
  412. -  XFree86 is distributed with a link kit so you can optionally
  413.     include what you like in the server.
  414. -  You will need lots of disk space (around 150Meg for the MIT core).
  415. -  Look at mit/server/ddx/x386/README and follow any instructions for
  416.     your particular platform.
  417. -  Contact the X11 channel at linux-activists
  418.  
  419.  
  420.  
  421.  
  422. XI.B  HARDWARE REQUIREMENTS:
  423. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  424. Approx: at least 4 megs of ram + swap ...slooooww. 10 Meg disk for X.
  425. Another 6-10 meg of disk for GCC if you want to compile X11 programs.
  426.  
  427. QUESTION: What VGA boards are supported?
  428.  
  429. ANSWER:
  430.     et3000, et4000, gvga, pvga1a, wd890c00, tvga8900, ati ver. 5 or 6,
  431.         8514/A, generic vga: 800x600 mono (Xmono), 640x480x16 (Xega).
  432.  
  433.     Diamond cards are not supported and will not be supported.
  434. Contact Diamond if you have further questions or (better) buy another card.
  435.  
  436. Standard x11v1.1 or xfree86 server:
  437.     ET3000         (for ex. GENOA 5300/5400)
  438.         ET4000         (Tricom, STB PWR Graph, Sigma Legend, etc.)
  439.         GVGA         (Genoa 6400)
  440.         PVGA1A         (Paradise VGA Professional) ... see BUGS.
  441.         WD90C00     (Paradise VGA 1024)
  442.  
  443. supported by xfree86:
  444.     TVGA8900     TRIDENT 8900 support is in xfree86    
  445.  
  446.     ATI        ATI VGA WONDER XL and most ATI VGA WONDER PLUS
  447.             cards (chip version 5 or 6).
  448.             Courtesy Rik Faith (faith@cs.unc.edu)
  449. ATI Notes: An example Xconfig file is available from ftp.cs.unc.edu:
  450. /pub/faith/linux/x386. Please note that:
  451. 1) clock.exe does *NOT* work with ATI cards.
  452. 2) The ATI Wonder driver in xFree86 is known only to work with
  453.    chip version 5 and 6 cards.  This is most ATI VGA Wonder PLUS cards
  454.    and all ATI VGA Wonder XL cards (although sporadic problems have been
  455.    reported even with these very recent cards). The driver will tell
  456.    you which ATI chip version you have, as will the ati.test program in
  457.    XLIB/etc/
  458.  
  459.  
  460. MONO    Any vga card should be able to use X386mono server. (At least
  461.     640x480 with 800x600 virtual). Use vga2 section of Xconfig.
  462.  
  463. Also available as ALPHA test versions (join the X11 channel):
  464. (The standard x386/xfree86 server will not handle the following cards)
  465.  
  466. 8514    ATI graphics ULTRA, ATI graphics Vantage
  467.     (should work with any VESA standard 8514/A register compatible card?)
  468.     tsx-11 pub/linux/packages/X11/X8514/  (X8514new.T.Z x.8514.src.T.Z)
  469.     courtesy Kevin Martin (martin@cs.unc.edu).
  470.  
  471. Xega    Generic 640x480x16 compatible server (originally for laptops).
  472.     This requires a microsoft mouse at /dev/mouse for now
  473.     and it does not use Xconfig so use environment variables
  474.     to define the font path etc. in .xinitrc:
  475.     export FONT_PATH=/usr/lib/X11/fonts/misc:/usr/lib/X11/fonts75dpi
  476.     Works better with courier fonts so add to .Xresources:
  477.     *Font: -*-courier-medium-r-*--10* ..or whatever..
  478.     A link kit is available at tsx-11 (you need gcc2.2.2).
  479.     in pub/linux/ALPHA/Xega/X386.ega.T.Z
  480.     courtesy Marc Hoffman (marc.hoffman@analog.com).
  481.  
  482. The Xega server is compiled with the gcc-2.2.2 libs and should be
  483. upgraded soon. It should however work with programs/fonts in new X11
  484. releases as long as you ensure you have the shared images needed by
  485. the server in /lib.
  486.  
  487.  
  488. XS3    S3 chipset server (Jon Tombs jon@robots.ox.ac.uk)
  489. I've started a FAQ on ftp.robots.ox.ac.uk (pub/linux/S3), but the Xserver
  490. is still very alpha. Unless you know something about X386 and are prepared
  491. to work at it, stick with the mono XFree86 server until you see different
  492. advice. I'd hope to get the server integrated with XFree86 in the next
  493. couple of weeks. This will make most the current problems go away.
  494.  
  495.  
  496. WARNING: Do not try to bring up an Xserver that does not support your
  497. hardware. There have been cases where damage has resulted from pushing
  498. the monitor beyond its specs.
  499.  
  500.  
  501. QUESTION: What Mouses are supported?
  502.     
  503. ANSWER: Serial : Logitech, Microsoft, MouseSystems .... compatibles ...
  504.     Busmouses : Logitech, microsoft, ATI_XL, PS/2 (aux).
  505.  
  506.  
  507. QUESTION: Has anyone gotten the "Mini-DIN" mouse on an HP Vectra 486/33T
  508. to work? The slight info I've been able to find says it's PS/2 compatible.
  509.  
  510. ANSWER: First you need to create an entry in /dev for it:
  511.  
  512. mknod /dev/psaux c 10 1
  513.  
  514. There is no direct PS/2 mouse support in XFree86 yet, so to use the
  515. mouse with X you'll have to use the mconv mouse protocol conversion
  516. utility, which can be found on nic.funet.fi, in
  517. /pub/OS/Linux/utils/tools/mconv.c. This program converts the packets
  518. sent by the PS/2 mouse into the corresponding ones from a Microsoft
  519. mouse, so you can fool X telling it you have a Microsoft serial
  520. mouse instead. Instructions for use are included in the source file.
  521. (Johan Myreen jem@cs.hut.fi)
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528. XI.C. LINUX DISTRIBUTION
  529. ~~~~~~~~~~~~~~~~~~~~~~~~
  530.  
  531. QUESTION: What is the current version?
  532.  
  533. ANSWER:    The newest public Linux release is x11v2.1. It is the linux
  534. release of xfree86-1.1. It was compiled with gcc-2.2.2d and is available
  535. for example at tsx-11 in pub/linux/packages/X11/xfree86-1.1/
  536. The SLS distribution stays at 2.0.
  537.  
  538. QUESTION: What Files do I need to download?
  539.  
  540. ANSWER: For x11v2.1: There is a README file in the distribution directory.
  541. Bring this down first and read it. Then get xbin, xman and xfonts.
  542. You need xprog and xlibman only if you plan to compile X applications.
  543. You dont need xkit if you want to relink the server.
  544.  
  545. **** You need The shared images libc.so.4 (4.1 or later) and libm.so.4 (4.0)
  546. in /lib/. All the X11 binaries use these. To compile programs you should
  547. get gcc-2.2.2d7 or later and the 4.x libraries.
  548.  
  549. For Other servers see also the notes in the previous section.
  550.  
  551.  
  552.  
  553. QUESTION: Where do the X11 files go? What are they?
  554.  
  555. ANSWER: x11v2.1 uses the directories /usr/X386/bin/ (XBIN) for programs
  556. and /usr/X386/lib/X11/ (XLIB) for support files.
  557.  
  558. The support files include default/example Xconfig, xinitrc, twmrc
  559. which you should copy to your HOME directory (as Xconfig, .xinitrc
  560. and .twmrc) and edit them to define your hardware and X11 setup.
  561. The directory XLIB/etc/ contains some documentation which
  562. should explain how to configure your video.
  563.  
  564.  
  565.  
  566.  
  567. XI.D.  LEARNING/USING X
  568. ~~~~~~~~~~~~~~~~~~~~~~~
  569.  
  570. QUESTION: Where can I find the basic help for learning/using X ?
  571.  
  572. ANSWER: Try man X386; man Xserver; man xterm; man twm; man xinit
  573. on any unix machine.  The man pages on xterm and twm will reflect
  574. behaviour on Linux systems quite accurately. The others will give you
  575. some bearing though not every option will work.  These man pages are
  576. part of the xfree86 distribution.
  577.     
  578.  
  579. QUESTION: What docs are available besides man pages?
  580.     
  581. ANSWER: The FAQ in comp.windows.x11 is extensive and has a bibliography.
  582. There is also the Xt-FAQ. Both are available from export.lcs.mit.edu in
  583. pub/contrib/.
  584.  
  585.  
  586.  
  587.  
  588.  
  589. XI.E. DEBUGGING STARTUP PROBLEMS:
  590. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  591.  
  592. QUESTION: How do I start up X?
  593.  
  594. ANSWER: Type 'startx' at the shell prompt.
  595. Before doing this you should:
  596. 1) copy the file Xconfig.sample from the XLIB directory to your
  597.     HOME directory (/usr/root/Xconfig?) or to XLIB/Xconfig.
  598. 2) Edit Xconfig and set the video data for you card and monitor.
  599.    Use the clocks appropriate for your card and the modes appropriate
  600.    for your monitor for those clock values. To determine what values are
  601.    appropriate read files in XLIB/etc and the Xconfig section below.
  602. 3) Set the mouse device in Xconfig correctly....Use the busmouse entry
  603.    for Logitech only. For other busmouses use microsoft.
  604. 4) Ensure that there is a termcap entry for xterm in /etc/termcap
  605.    (One is available in the subdir /doc).
  606. 5) Ensure that the X11 binaries are in the path example:
  607.    add the line PATH=${PATH}:/usr/X386/bin to ~/.profile or
  608.    look at bash.ad in /doc.
  609. WARNING: NONE of the modes (in the Modes line in Xconfig) should use a
  610. clock your monitor cannot handle.
  611. Now type startx.
  612.  
  613.  
  614. QUESTION: I cannot type in my xterm
  615.  
  616. ANSWER: /dev/console must have major=4, minor=0
  617.     rm -f /dev/console; ln /dev/console /dev/tty0
  618.  
  619.  
  620. QUESTION: What are some of the common omissions and errors?
  621.  
  622. ANSWER: (Peter)
  623. 1) Add /usr/bin/X11 (or /usr/X386/bin) to your path.
  624.  
  625. 2) Add the xterm termcap entry to /etc/termcap.
  626.  
  627. 3) ln -s X386 X in the XBIN directory.
  628.    ln -s X386mono X (if you want to use the mono server).
  629.  
  630. 4) Run X as root first. This avoids some trivial problems.
  631.  
  632. 5) If you change the font path entry .... X386 is finicky about
  633.    the syntax.
  634.  
  635. 6) Make sure your mouse entry in Xconfig points to a legitimate serial
  636.    device  (or busmouse)... usually something like:  microsoft "/dev/ttys1"
  637.    serial devices have major # 4 minor 64,65 ... busmouses are major 10.
  638.    ls -l in /dev will show you the major and minor entries.
  639.  
  640. 7) Need read/write/exec access to /tmp directory
  641.  
  642. 8) Use startx 2> x.err to log your error messages. If the server sticks
  643.    and you have to reboot you'll probably loose this stuff... see notes
  644.    on `hanging' below.
  645.  
  646. 9) See Xconfig problems and the device list below.
  647.  
  648. 10) Have you read the X386 man page?
  649.  
  650.  
  651. QUESTION: Why is the server unable to find some of the fonts?
  652.  
  653. ANSWER: First check that the directories listed in the font path exist
  654. and have font files in them. Some of the servers are not set up to use
  655. compressed fonts. In such cases you have to uncompress the fonts in the
  656. directory and run `mkfontdir .`. Read the man page on mkfontdir.
  657.  
  658.  
  659. QUESTION: My server "hangs" Why?
  660.  
  661. ANSWER: (Peter) Quite often it isn't a hang. If the server grabs the
  662. screen(and enters graphics mode) and then dies, it may return you to
  663. bash *without* restoring the screen. In other words, just because you
  664. see no output, don't assume it's running/hanging.  The way to test
  665. this is to see if you can use a bash command to spin your disk. eg.:
  666. sync; ls -l /bin.
  667.  
  668. Also - I *suspect* that (at least for me), you can kill the
  669. server if you include the servernum option in the Xconfig
  670.  
  671. You can kill the server when you want to by typing ctrl-alt-backspace.
  672. Then a couple of ctrl-C 's in case your stuck in xinit.
  673.  
  674. The two line message
  675.          X386 version .....
  676.          (protocol Version ....
  677. is returned from the X386 programme itself, so if you get
  678. this (or if the screen blanks) X must be starting.
  679.  
  680.  
  681. QUESTION: When I try to use X11 I got "Cannot connect to
  682. server" or "process does not exist", any clue ?
  683.  
  684. ANSWER: The cause might be wrong fontpath variable setup in your
  685. Xconfig; uncomment and set the correct fontpath variable.
  686.  
  687.  
  688. QUESTION: Why cant I run more than 4 xterms?
  689.       How can I have more than 4 pty's ?
  690.  
  691. ANSWER: set the number in the header include/linux/tty.h and
  692. recompile the kernel. Also make nodes :
  693.     mknod /dev/ptypxx 4  minor  (where minor = 128 + xx)
  694.     mknod /dev/ttypxx 4  minor  (minor = 192 + xx)
  695.     This is for before linux-0.97pl6.... for later versions
  696.     you only need to make the nodes.
  697.     
  698.  
  699. QUESTION: I have trouble with my logitech Pilot mouse and X under
  700. Linux, any clue ?
  701.  
  702. ANSWER: (Thomas Roell?) There are TWO line of Logitech mice out there.
  703. One is the programmable and uses MouseSystems protocol at startup.
  704. X386 reprogramms them to use another protocol. If you specify
  705. 'Logitech' in the Xconfig, X386 assumes a mouse like C7 or S9 (notC7-M).
  706. The second line is the MicroSoft compatible. Currently all newer
  707. Logitech mice follows this practice, like the MouseMan. In that case
  708. you have to say 'MicroSoft' or 'MouseMan'.
  709.  
  710. From: jliddle@rs6000.cmp.ilstu.edu (Jean Liddle)
  711. I just purchased a new logitech mouseman, and yes, the new X-Windows
  712. (XFree86 as opposed to X386) requires that you use the "microsoft" mousetype.
  713. However, if you turn Third Button Emulation off, the middle button WILL work.
  714.  
  715.  
  716. QUESTION: How does X11 start up?
  717.  
  718. ANSWER: The startup involves the server (XBIN/X), and some
  719. programs like startx and xinit.
  720.  
  721. Typing startx runs the script  XBIN/startx. Look through startx.
  722. For explanation of the server arguments try man Xserver.
  723. startx does little other than gather arguments and then call xinit.
  724.  
  725. xinit **calls** X (X is linked to X386). xinit therefore continues to
  726. run, and quite often you will receive error messages from xinit rather
  727. than X itself. If you get the message "giving up", it means X has died
  728. (quite probably it died immediately) and xinit has been unable to start
  729. x applications. xinit processes the startup script xinitrc.
  730.  
  731.  
  732. QUESTION: How can I see what startx passes to xinit, and xinit to X?
  733.  
  734. ANSWER:  Add the line:  set -x      near the top of startx.
  735.  
  736. To see what xinit passes to X, try: (Peter)
  737.  
  738.     rm XBIN/X
  739.  - yes, if you have set it up correctly, X should only be a link
  740.  so it's safe to remove it.
  741.  
  742.  then create a shell script XBIN/X containing:
  743.     #/bin/sh
  744.     echo $*
  745.  and run startx. You should see something like:
  746.     X :0
  747.  which is all xinit passes to X. If you don't see the :0, you may not
  748.  have your DISPLAY=":0" set correctly. THEN RESTORE X!! :
  749.     cd XBIN; rm X; ln -s X386 X
  750.  
  751.  
  752. QUESTION: What devices does X depend on:
  753.  
  754. ANSWER: check your device numbers with ls -l /dev. You should have:
  755.  
  756. 5 0 tty
  757. 4 0 tty0
  758. 4 0 console
  759. 4 1 tty1 (etc)
  760. 1 1 mem
  761.  
  762. 4 128 ptyp0         pseudo ttys used by xterm/emacs etc
  763. 4 129 ptyp1 (etc)    to talk to unix programs.
  764. 4 192 ttyp0
  765. 4 193 ttyp1 (etc)
  766.  
  767. 4 64 ttys1         one of these is the mouse
  768. 4 65 ttys2        or you have a busmouse.
  769. 10 x mouse         busmouse x = 0 => logitech     1 => ps/2 (aux)
  770.             2 => microsoft        3 => ATI_XL.
  771. /tmp/.X11-unix/X0       socket used by X apps to talk to the server.
  772.             this is created by X386.
  773.  
  774.  
  775.  
  776.  
  777. XI.F. Xconfig: Xconfig and Video mode settings.
  778. ~~~~~~~~~~~~
  779. QUESTION: What do the mode names mean?
  780.  
  781. ANSWER: The mode names like "640x480" are used to match entries in
  782. the modes line with the modeDB entry which actually defines the mode.
  783. You can toggle between modes in the modes line  with ctrl-alt-numericplus.
  784. If you're experimenting with 640x480 you can define
  785.       modes "640x480a" "641x480b" "642x480c"
  786. with corresponding entries under ModeDB so you can toggle between
  787. these three modes. Try man X386.
  788.